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INTRODUCTION 



The following is a list of notes to be inserted in the ABL Provisional 
Prograraniing Manual. Some of the notes take the form SEE A'lEHDMSNT 
so-and—so, and a numbered list of amendments folloxfs the list of notes« 
The remaining notes are themselves short corrections or amendments, A 
typical, reference to be written in the manual at the appropriate point 
might be SSS A3/2 (Al'iENDMMT 3 OF E & A 2). 
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PAGE SECTION INSERT 

6 after 2.5 AMEI'JDMENT 1 of E & A No . 2 contains a nevf 

section on the complete range of Atlas 
addresses. 

ih %.3 If Bm is BO in the l6k and 165 instructions, 

then bn?g-n gives n rather than 0. 

17 4.6 About instructions 200, 201, 202, 203 : If 

Ba and Bm are the same B-line and the test 
succeeds, its final contents are n. If Bm 
is BI27 (and Ba is not), these instructions 
give an unpredictable result, 

-18 4.7 About instructions 220, 221, 222, 223 : If 

Ba and Bra are the same B-line and the test 
succeeds, its final contents are n. If Bm 
is BI27 (but 3a is not), these instinictions 
give an unpredictable result. 

See AI«fENDJffiNT 2 of E & A No. 2 for a more 
complete version of this section. 

See AMENDMENT 3 of E & A No. 2 for a new- 
section on the B-carry digit. 

See AMENDMENT 4 of E & A No . 2 for more on 
ABL format. 

See AMENDI-IENT 5 of E & A No. 2 for a more 
complete version of this section. 

See AMENDMENT 6 of E & A No, 2 on setting 
preset parameters by an interlude. 

If * is not set at the head of an ABL program, 
* = 1: is assumedo 

See AMENDMENT 7 for more information on ABL 
floating point numbei-s. 

Any optional parameter settings to be made 
for a library routine should occur before the 
L directive that calls that routine. 

29 5.13 Bl to B88 are cleared before a program is 

entered by E, ER or EX, B89, however, contains 
the current value of *. After an E directive 
B90 contains J3 ; after ER and EX B90 is clear. 
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PAGE SECTION NOTE 



33 6.2,3 The inequality 11 lines do\m. in this section 

should read sx < ^9 

43 7.4,6 J.400 - the imaginary part of the complex 

logaritliin will lie in the range — 7r(not 
inclusive) to TT (inclusive) . 
I4l0 - of the two possible values of the 
complex square root, the one computed here 
has a non-negative real part; the remaining 
ambiguity about the square roots of negative 
real numbers is removed by computing the one 
whose imaginary part is positive. 

48 to ^6 Chapter 8 has been replaced altogether by a 

separately produced document. y^^ae the cover 
page of the present document) , The following 
fact should be mentioned on page 24 of that 
document : ¥hen 5 hole tape is read in binary 
the order of the bits as they appear in the 
store is the reverse of the order sho'tm. in 
the Internal Character Code table (pages 100 
to 103) in the programming manual. For example 
open brackets '(* is listed on page 100 as 
FS 001,01 and when stored in binary it appears 
as 000000 010100. The card showing the Atlas/ 
Orion punched tape code (CS 308b) gives 
the bits in the order given by the manual, 

57 9»1 The range of tape numbers (3rd paragraph) 

should begin at zero rather than one'o 

59 9»3 Paragraph 5j line 3 should state that "the 

start instruction must be preceded by the 
word search instruction 1044", 

60 See AMENDMENT 8 of E & A No. 2 for more details 

on the 1032 and 104c instructions^ 

61 For a correct definition of the I'Jhere am I? 

extracode (l024, not 1022 as listed) see page 
67 of the manual. 

61 See AMENDMENT 9 E & A No. 2 for more details 

on the 1044 word search extrocode, 

65 & (>6 Replace everything from (and including) the 

final paragraph of section 9«5.4 (Safeguards) 
to (and including) the IOI5 (Read title) 
extracode on page 66 with AMENDMENT IC of E&A 
No. 2, 
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PAGE SECTIOIT NOTE' 

68 to 76 Chapter 10 has been replaced entirely by a 

separately produced document, (See the cover 
page of the present docuement.) The rollowing 
additional rule for the preparation of document 
and tape titles should be inserted on page 3 
of that document (Preparing A Complete Program - 
section 10.3.3) : 

d) a title must not contain 
three successive asterisks 

Under section 10.4.2 on the OUTPUT section of 
the job description it should be stated that a 
request will be made to the operator to mount 
special stationery for a given output stream if 
an asterisk is placed in front of the word LII^E 
PRINTER. Thus if output stream 3 is to be printed 
on special stationery, the output section should 
contain 

*LINE PRINTER m BLOCKS. 

78 TJhen the rename extracode (ll64) is used there 

must be at least one more block allowed for 
in the job description than is defined at that 
moment , 

78 The list of definitions of P^ , P2, etc;. should 

have added to it: sector number k= bits 21 to 
23 of ba. 

79 See AMEKEM-INT 11 of S & A No . 2 for two new 

extra codes and eorrected versions of the drum 
extracodes II75 and II76. 

85 11.4 See AMENDMENT 12 in E & A No. 2 foi information 

on ABL raonitoringa 

86 See AlVCilfDMENT 13 in E & A No. 2 for an up-to-date 

version of the Supervisor fault table.', 

87 11.4,2 The va3-ue of main control left in the 3-line is 
(line 9)the value when the fault v/as detected and may 

not be the address of the instruction which 
caused the fault, 

87 11.4,2 The entry opposite n = in the table explain- 

ing the 1114 (exit from trap) extracode should 
read ' compile the program again and enter it 
at the beginning, making the original data 
available to the re-compiled program, ' 
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PAGE SECTION NOTE' 

87 11'b497o Atlas restart procedures are being reorganisedo 

At present when a computer failure occurs all 
jobs not using magnetic tapes are recomputed 
and entered at the beginning. The restart extracode 
1113 should not be used until further notice, 

88 lli'4V%»' The address left in B32. is the value of main control 

when the fault was detected, which may not be 
the address of the instruction which caused the 
fault. 

89 11.4. 5a. See AMENDMENT l4 .in E & A No. 2 for a corrected 

description of the 111? 'end program' extracode 

89 11.4'«6," This example is incorrect, 

^» The 1115 extracode icrites all the blocks of 

the program (not the input or output streams) 
to private tape in ascending order of bZa ck 
labels. Omit the words 'instead of onto systems 
tape' - no such dump is ever automatically made^ 

92 The lll6 extracode is not currently useful 

since programs are not automatically dumped 
onto systems tape when they are monitored, 

93 See AMENDMENT l4 or E & A No«2 for a full 

description of the 1117 extracode. 

95 See AMENDMENT 15 of E & A No, 2 for additional 

documents concerning Atlas, 

99 The V-store address J6OO9IOOO given for type 

4 equipment refers to the Analex Line Printers 
(not the I.G.T, Hammer Printers )s 

100 & (ampersand) is 8,5 on cards. 

Other characters available on cards but not listed 
in the manual are: 

Colon 6,8- 

Open square brackets -^7,8 

Close square brackets -,6,8 

Underline +,6,8 

Vertical bar +,7,8 
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2.6 THE FULL RANGE OF ATL/V.S ADDRESSES 

As e^cplained in 2. 4, address bits 1 to 11 represent the 
number of the 512 word main store block to which that address; 
refers, so that an Atlas main store address refers to one of 
2048 blocks. In octal (for* the J notation see 4,3) these block 
addresses are JOOOO, JOOOl ,^ J0002, , . . , , J3777 and in their 
decimal representation (see 5.6) Oi, 1:, 2:,..., 2047 : . The 
ABL compiler and the program it is compiling share , the same 
range of block numbers, with ABL occupying blocks in the range 
J3 to J34. Consequently to avoid over-writing itself /iBL -will 
refuse to compile program into any of the 256 blocks 1536: to 
1791: Once the program is compiled and ABL has withdrawn from 
the store these blocks become available again and can be used 
as working space by the program , 

The remainder of the main store block numbers J34 to Jk 
are illegal, ABL will not store program in block J3 or above 
and the Supervisor vrlll fault the program if the compiled program 
attempts to refer to block J34 or above. 

In fixed store and private store addresses bit is a 1. 
There are therefore another 2048 blocks that can be addressed 
and they have octal addresses J4000 to J7777, The first l6 of 
these (j4 to J4017) are the block numbers of the fixed store 
and may be referred to by the programmer if he wishes, although 
there is generally no reason why he should do so. The block 
numbers J4020 to J4777 are also quite legal. In effect these 
block numbers refer to 31 consecutively stored copies of the 
fixed store. For example either of the instructions 

101 3 o J4017777 

101 3 -1J5 

would place the same half word in B3, namely the left half of 
the last word of the fixed store. In other words addresses in 
the range Jk to J5 are in effect masked with J40177777 before 
execution (for a definition of masking, or what is the same 
thing collating, see 4,3) 

The private store block addresses J5 through J7777 are 
completely forbidden to the ordinary programmer. These addresses 
ca n be referred to on extracode control. However it is impos- 
sible for the programmer to force an extracode to refer to the 
private store. He is prevented by faulting an extracode 
instruction in which the modified address is in the private store 
but the unmodified address is not. Thus for example a program 
containing the instruction 

1730 j6 am' = sin (J6) 

would be thrown off because the first instruction of the 
extracode routine is 

324 11.9 am' = (bll9) 

(B119 will contain the address J6 upon entry to the extracode. 
See 7.2). 
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4.11 Restrictions on the Use of B-registers 

Although B81 - B119 were included in section %.l as 
general purpose B-registers, they are of limited utility for 
the ordinary programmer, since they are each used by one or more 
of the system routines -which may assume control during the riinning 
of the object program. Before using any of these B-registers, 
the B-test register, the substitution register, or the 3~carry 
digit, the programmer must check to see that there is no danger 
of their contents being overwritten before he has finished xirith 
thera. 

The routines which these B-registers are as follows:- 

B81— 89 Library routines 

B90 Return link from library routines 

B91-97 Extracodes 

B98«»99 The logical Accumulator and some 

less common extracodes 

BlOO-110 Supervisor 

B111~118 Interrupt routines 

BII9 Extracode operand address 

B121, 122 Extracodes, library routines 

Bt, Be Extracodes 

It should be noted that the library routines may use 
extracodes. This means tha.t when library programs are in use, 
no B-line above B80 should be used (except for B90) . Provided 
no reference is made to library routines, B8I - B90 may be 
freely used. Similarly B81 to B99, B121, B122, Bt and Be are 
safe to use when neither extracodes nor library routines are in 
use. ' It is never safe for an ordinary program to use BlOO - 
B118, since an interrupt can occur at any time and cause control 
to be transferred to the Supervisor, 



AMEWDMEI'lT ^ 

4,11 The B-carry digit 

I'Then any one of the fo^o? addition codes 

104 ba' = ba + s 

114 s' = ba + s 

124 ba' t;3 ba + n 

164- ba' = ba + (bm & n) 

is used to add two 24-bit quantities, bit 23 of line 6 of the 
V-store is set to 1 if there is a "carry* from the addition. 
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Thus for example the addition of any two 24 -bit numbers whose 
leftmost bit is a 1 sets the 'B-carry digit' to one. If there 
is no. 'carry', the B-carry digit is set to O. Tfhen an ABL 
program is entered the B-carry digit is clear. 

The singly - modified extracode 1223 loads Ba with n if the 
B-carry digit is set to 1 and does nothing if it is not set. 
(The exti-acode does not affect the state of the B-carry digit . ) 
The following example uses 1223 to add bl to b2 and then add the 
'carry', if any, to the bottom of B3, Thus the contents of Bl 
and B2 are here regarded as 24-bit positive integers whose 
double length stira is placed in B3 and B2 with the most significant 
half in B3, 

Example 

124 2 10 
1223 3 3 Yl 

Similarly each of the ten instructions 

ba 
ba 
ba 
ba 
ba 

set the B-carry digit to 1 v^hen, regarded as 24-bit positive 
integers, a larger number is subtracted from a smaller. Other- 
wise these codes set B-carry to zero. For example, the B-carry 
digit is set to 1 by the instruction 172, 0, 0, 1. 

Example 

In the previous example bl was added to b2 and the double 
length sum held in B3 and B2. The following two instructions 
would subtract bl off again from the double length sum. 

122 2 1 
1223 3 3 -Yl 



100 


ba' = s 


110 


si = s 


120 


ba« = n 


150 


bt' = s 


170 


. bt' = n 



102 


ba ' = ba — s 


112 


s ' = ba - s 


122 


ba ' = ba - n 


152 


bt ' = ba -' s 


172 


bt' = ba - 13. 



AFJE^IDMEI-TT 4 

A complete line of ABL input is read, and an image of 
the print-out is formed, taking correct account of the characters 
SPACE, BACKSPACE, and TAB. TAB is interpreted assuming 9 fixed 
TAB positions, at 8, l6 , 24, 32, and then every l6 up to 112, 
character positions from the left-hand margin; TAB always moves 
the current 'carriage position' along at least two character 
positions, A maximum of 128 character positions along the 
line is allowed for; any characters beyond position 127 are 
ignored. A backspace beyond the left~hand max-gin is ignored. 
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In intei-preting a line, EHilSE, or a composite character 
including ERASE, is everywhere ignored (except in circumstances 
where a direct copy of* a string of characters is called for - 
see section 5.10.) 

The character small 1 is an illegal character. Otherwise 
ABL treats upper and lower case letters as being identical. The 
letters capital and capital I are treated as alternatives 
to zero and one. 



AMENDI-iENT ■? 

5.3 PRESET PARAMETERS 

Preset parameters are not associated w ith any particular 
routine and are meant for use by the program as a v/hole. 

One hundred preset parameters PO to PlOO are allowed, 
PO may also be written P. Certain preset parameters with 
numbers greater than 100 have special effects, described in 
amendme n t 12, 

Preset parameters can only be set directly by an equation 
(P3 = 10) and cannot be set by labelling. Unlike routine 
parameters they cannot be referred to before they have been 
set (see Atnend, 12 . for faulting action). Hox^ever, preset 
parameters can be reset to a new value later in the program 
(later in the sense of being compiled later). Thus, the 
same preset parameter can be used as often as is convenient 
with different values, e.g. see the use of P123 described in 
5.10,, (Taken from Page 4 of E&A No»l)o 

In connection with the optional setting of a preset 
parameter (see 5-5) one may direct the ABL compiler to regard 
a preset parameter as never having been set by writing Ua 
(unset Pa)o Similarly Ua-b means unset Pa through Fb, The 
directives P=l , Ul , P?=:2, compiled in the order given, result 
in preset parameter PO being set to the value 2. 

The compiler always sets a preset parameter immediately 
upon finding it in the program. Thus, everything on the right 
side of the equation which sets a preset parameter must itself 
already have a value. This means that P = 6IA/3 would be 
faulted if it occuri-ed in the program before label of routine 
3 had been defined. 

It takes somewhat less time to compile preset parameters 
than routine parameters. 
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AMENDISIENT 6 



5.3.1. PRESET PARAMETERS SET BY PROGRAM 

Normally the values of all the parameters used in 
the program are determined during compilation of the program 
and before the program is entered. Indeed when compilation 
is terminated by an E directive the ABL compiler along with 
its lists of parameters is removed from the main store. 
However, the compiler and its lists are still in the store 
when the program is entered by an EX or an ER directive, 
although only the list of preset parameters is made avail- 
able to the (partially) compiled program. By using the 
special preset parameters described in AoQudmS-Z the programmer 
may then enter a part of hi.s program and set a pjt'oset 
parameter, then re-enter the compiler to compile the 
remainder of his program. 

In the following example P40 is set to the value of the 
integer which is the first item of input stream 7, Note 
that the program input stream (input ©in this example, 
although in general the lowest numbered input) must be 
reselected before ABL is entered again. Otherwise ABL 
would trdat input 7 as if it contained the program, 

JOB 

P5OO6/PROGRAM TilTH INTERLUDE 

INPUT 

7 iroiyiBERS HEADED BY Ml INTEGER 

COI'IFILER ABL 

LI 00 - LIBRARY ROUTINES USED IN AN 

- INTERLUDE I'lUST BE CALLED EXPLICITLY 



>- CALL INPUT 7 
*. b8l ' = INTEGER 
.L. p4o =. .INTEGER 

- bl > = MASK 
-«p40 is SET' 

-•- SESELECT INPUT 
T RE-ENTER COMPILER 

- COMPILATION C^ONTINtfES'feERE 



1050 








7 


1362 








A2/L100 


113 


81 





40P121 


121 


1 





J2' 


117 


1 





40P122 


1050 











121 


127 





P120 


EXA 








(frograh 


USING 


p4o) 


E (ENTRY 


foimt) 




***z 
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AMENDI-iai^TT 7 

Some ntyfces on ABL floating point numbers 

If the program contains a floating point number that is 
to large to be stored in Axlas standardized form the 
program will be monitored during compilation and the 
fault indicated by the monitor printing EXPONENT 0TERPL0¥. 
If a floating point number is too small to be represented 
in standardized f ortn ABL will store floating point zero 
in its place and continue compiling the program. 

If the exponent of a floating point number is forced to 
a value that .is too small to allow the number to be 
represented in standardized form, the program is monitored 
and AO on fixing is printed to identify the fault o 
For example, +lfO requests that 1 be stored in ixoacing 
point form with exponent zero, which cannot be done —1:0 
would be acceptable )» 



AIvIENDI-^NT 8 

1032 Prepare to \\rrite forwards on tape Ba in variable length 
mode , 

This instnaction must be preceded by a 1044 word search 
instructiop , even -when the desired word is the first 
in the block. (A block search should not be used and may 
result in the record being written starting at the wrong wor-d 
word on the tape). 

A buffer will be set up by this extracode in the K+1 blocks 
P, P+1,...,, P+K (These blocks must have been allowed for 
in the job description. If one of these blocks is already 
in use by the program, the information in it will be lost. 
Strings of inforination with markers at either end are trans- 
ferred to these buffer blocks by the 1040 instruction and, 
when a buffer block is full, it is written to the tape Ba 
mentioned in this instruction. The buffer blocks are not 
protected from the main program but they should not be 
referred to directly under any circumstances.) 

¥hen the first record is written with the next 1C4C 
instruction it will begin with a 7 marker, (if a different 
marker is required the 1042 'mark' instruction must be 
used prior to the 1040 instruction. ) 

Select tape Ba for succeeding variable -length operations, 
(This means that if no other tape is selected in the 
meantimejall succeeding transfer (l04o) , skip (ic4l) and 



string, 
EXAMPLE 
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mark (l042) instructions apply to this tape.) 

If tliere is already a 'write buffer' set up for tape Ba 
(by an earlier 1032 instaruction) the information it 
contains will be written to the tape and the second 'write 
buffer' will be set up. The first record written via the 
'new' buffer will then immediately follov/ the last record 
\inritten from the 'old' buffer and will begin with the same 
marker as the ohe which ends the previous record. 

It may be desirable to read vdriable length records from 
a tape for a while and then begin writing to the very next 
record on that tape. The 1032 instruction will switch modes 
in this -way. The first record written will begin with the 
same marker at the one which ends the previous record. 

TThenever variable length writing is terminated on a given 
tape each buffer block that contains information there 
by a 1040 instruction is v/ritten to tape. (a buffer block 
is not written to tape unless it contains such information.) 
This means that the first few v/ords of the last buffer 
block written may contain the end of the final record (or 
even just the final marker) and the rest of the block 
contain perhaps the remains of some preyiously transferred 
records. This fact permits one to over^irrite individual 
records without disturbing the records on either side. 
This is done by filling the buffer with the record that is 
to be overwritten along with the records (or part of the 
records) on either side of it. One aligns on the marker 
at the beginning of the record and starts reading forward 
(1030) with a buffer large enough to contain the whole 
record at one time. One then skips' (l04l) the record 
in question, starts reading backward (103I, with the same 
buffer) and fekips ' back over the record to the beginning 
marker. One switches to write mode (1032, same buffer again) 
and writes the new string in its proper place. A 'stop' 
instruction (l043) will then finish the job by causing^ the 
buffer blocks, now containing the new string in place of 
the old, to be written back to the tape. The two uses 
of the skip instruction are necessary to make the marker 
at the beginning of the old string available for the 
construction of the ma rker at the beginning of the new 



There is a 50 word record in section 10 of tape 33 which 
is preceded by a '7' marker in word 177, Replace that 
record with the 50 consecutive words beginning in the store 
at A3, leaving the '7' marker tmdisturbed, 

3) H10,177 Section 10, word I77 

search for marker 
Fill the one block buffer 
skip to end of next record 

(program continues on next page) 



H10,177 








loi^^ 


33 





A3 


1030 


33 





15 


104l 












1031 


33 





1: 


io^i 











1032 


33 





1: 


i?i 


75 





50 


lO^lO 


75 





A3 


3,Ck3 


33 
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Read backward 

skip back to feead of 
record 

switch to write mode 



replace record in buffer 
write block 1: to section 
10 

Although in the example just given the length of the string 
was Icno'vni in advance and BO mentioned in both of the skip 
instructions, one could use one of the skip instructions to 
pick up the length of the string in a B-line. 

If in the above example the 1032 write instruction is re- 
placed by a 1042 mark instruction, the program will replace 
only the mark at the head of the string. 

ITCTB ON THE lOhO TRMISFER IHSTHUCTICN 

It is not advisable to write with the octal fraction bi5-=0, 
because when the resulting string, which therefore ends 
with a zero marker, is read back, the octal fraction bKwill 
be zero regardless of whether reading ended at the zero 
marker or somewhere short of the marker within the string 
itself. 



AMENDMENT 9 

lOhk ¥ord Search 



This instruction positions the tape before section A of 
tape Ba and defines the 'next word' Tf at which extracodes 
1030 and 1032 begin reading and writing forward. A must 
be stored as a 21 bit integer in the left half of the full 
word whose address is S. ¥ occupies the right half word 
and is also a 21 bit integer« If tape Ba is not defined 
the program is terminated by the Supervisor, The program 
is also terminated if A~ -;' or if Ai4999« This instruction 
(rather than the block search ICOl) must be used before 
starting to read (103G, IO31) or to write (1032) variable 
length records. 
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AMENDMBNT 10 

9.5.4 (last paragraph) 

TJlien a magnetic tape has useful information on it, a 
o/lZ^lZ"- ^ii" °^ ^^^^ information is stored in block 
which iiS!; ^^^!/^ ^" addition to the tape serial nuniber, 
SternSl o^r^j;^^^^ associated with the tape and is un- 

?ir^r^r\ ^"^1 *^°^Sh the Supervisor prints out only the 
taSe ±r^t?r^? J""^ ^f operator messages. It is stored on 
r^S^i V !\?''*^''"^^ ^°^^ ^^^*^ *^b ^"d multiple spaces 
taSs ?;?f *f ^ ^-placed by a single space; initial spaces, 

are iJoiL !r^^t .''°'^'^^^ ^""^ ignored. Redundant shifts 
are xgnored throughout the title. See Chapter 10. 

^'^ Organiza tional Instructions 

A number of organizational instructions are provided to 
cope wxtn special situations v^ich will arise in Lmlnagnetic 
p:??o?.rfrn;uair^ °^ *^^ operations which these inst^Mo^. 
lloTran ILtZ^ required near the beginning or end of the 
or the ilS rP^r ^""^ *hen best left to the job description 
°^T iP )^'^^ program) instruction. One exception to this 

t:p:^?s'n:t'Je^uirengai:? ^" *-^' information on any titled 

...^1 /'^°Srams ■ frequently require to use magnetic tapes as 
working space, without wanting to keep them after the%ob 
has been run. Such magnetic tapes should be requested under 
a heading TAPE COMION in the job description. 

For a long job, it may be desired to restart the iob 
after a machine failure severe enough for common tapL'to be 

H°.f ' Tn e^o^^^^ ""^f^ ^""^^^ ^^°"^^ ^^ requested under TAPE 
In I o. exceptional circumstances a title may be written 
iob h^r H *^P^' ^^^i^l^ i- ^^^en kept by the uLr after tL 
job has ended; the operator w ill be notified, and the 

aim tSis'ai\*iro??L!^^° ^^''°" '° discourage a user from 

i-r. -K ^^^^^"^i*!^ Stored in section C of the tape is referred 

Block V TTi"" ^'-S'-^ ""^ ^^^^ (^^"i*- Title I Search for 
Block 1, and Read Title or Tape Number). These refer by its 

record %\ffbJ^ oh " ^^^ ^'^ *^^ *^^^ *^*^^' stored L one 

s:rciar:c:er"irbin:rr^:?:.^^^ ^^^^^^ « *° ^ --- -- *^^ 



9.6.1 Mount Instnicti 



ons 



If a program requires to use magnetic tape, its iob 
description must indicate the number of magne^i^-tape 
mechanisms required. Normally this is done by listing the 
ma^etic tapes which are required to be mounted on i^ese 
tZ^TV ^"^*^^^ly^ *he Supervisor will then ensure that 
detaJl^n^'l ^"^r^'"'^^^ '^^^^^'^ *'^^ P^°S"-"' i- entered. tSc 
Chapter iS *''" '°^ description is prepared are given in 
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If" f^^rthe^ magnetic tapes are required after a program 
has been entered, they should be listed in the job description 
and Eiay then be called in by obeying "mount" instructions. 
However, the total number of mechanisms in use at any one 
time must not exceed the number reserved in the job des- 
cription, A mount instruction should, if possible, be 
obeyed at least 2 minutes before the tape to which it refers 
is required; othert;rise the tape may not be ready in time 
and the program will have to wait. Note that the program 
will be monitored if it calls for a new tape to be mounted 
at a time when none of its reserved mechanisms has been made 
free. If there is a spare tape mechanism, the tape may be 
mounted on it b y the operator before the program calls for 
it. 

The tape reference letter referred to in the mount 
extracodes is a letter associated with the tape in the job 
description (see chapter lo) . 

The mount instiructions are as follows:- 

1010 Mount 

Allocate the number Ba to the tape whose tape reference 
letter is in the 6 least significant bits of n, in internal 
code. If this tape is not already available, instruct the 
operator to mount it on any available tape uechanism. If 
the tape is in the TAiE category, check its title; if in 
the TAF3 NE¥ category, write into the section the title 
given in the job description: if in the TAPE CCIIIiON 
category, leave the tape matitled. 

1011 Mount yree 

Allocate the number Ba to a free tape. If no free tape 
is available, instruct the operator to mount one on any 
available tape mechanism. 

This extracode should only be used in exceptional circum- 
stances; normally all tapes required should be listed in the 
job description. The operator \i±ll be informed whenever 
this extracode is used, and an installation nay take action 
if it is used overmuch, 

1007 Mount Next Reel of File 

Allocate the number ii to the next reel of file Ba, If 
this tape is not mcunitGd^' , instruct the operator to mount 
it on any available mechanism. 

The following motint instructions refer to logical channel 
ntimber {K= to 3) of a given program. These logical channel 
numbers do not each refer to a fixed magnetic-tape channel: 
they are merely a device to enable the program to separate 
on to different channels the majgiaetic tapes that it requires 
to operate simultaneously. On an installation with only 
one tape mechanism on each of the eight tape channels, there 
is no advantage in specifying channel numbers. On larger 
installations, the tape mechanisms are grouped together on 
pairs of channels, and the logical channel numbers then 
refer to these pairs. 
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A program's referring to logical channel niaiiber K has 
the follov/ing effect. Xf no channel has been previously 
desig-nated' logical channel K of the program, the new tape 
is mounted, if possible, on a channel different to any which 
has been previously designated a logical channel of the 
program; that channel is then designated logical channel 
K of the given program. If a channel has been previously 
designated logical channel K of the program, then the new 
tape is mounted on the same channel, if possible, A channel 
may also be designated logical channel K of the program by 
the Job Description; see chapter 10. 

1012 Mount on Channel K 

Allocate the number Ba to the tape whose tape reference 
letter is in the 6 least significant bits of n, in internal 
code. If this tape is not already available, instruct the 
operator to mount it if possible, on channel K of this 
program, where K is the most significant octal digit of n. 
If the Tape is in the TAPS category, check its title; if 
in the TAFE NEW" category, write into section the title 
given in the job description; if in the TAPE CGM-iON 
category, leave the tape untitled. 

1013 Mount Free on Channel K 

Allocate the number Ba to a free tape. If no' free tape 
is available, instruct the operator to mount one, if 
possible, on channel K of this program, where K is the most 
significant octal digit of n. 

Note that this extracode, as 1011, should be used only 
in very exceptional circumstances; normally all tapes 
required should be listed in the job descx'iption. The 
operator ^dll be informed whenever this extracode is used 
and an installation may take action if it is used overmuch. 

9.6,2 Cthei; organizational Extracodes 

101 4 ¥rite Title & Search for Blocl< 1 

T-Jrite to section of tape Ba the title stored in 
locations S onxvards , over\-7riting any title that may be there. 
Inform the operator that this has been done. 

1015 Read Title or Tape Number 

If S is even (least significant bit is O) , then store 
in locations S onwards the title of tape Ba , i.e. that 
currently in section 0. 

If S is odd (least significant bit is l) , then store 
in location S the tape number of tape Ba. 

In IDl'^ and 1015 S is taken as a half word add-^ess. 
The tape serial number stored by 1015 will be in internal 
code, left justified, 8 characters in length. 
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AMENDMENT 11 

Two new extracod.es for use in keeping track of the 
blocks wliich have been defined in a prbj^ram are ; 

1135 b91' = c and c' = n if block number -^ba newly defined 

Henceforth, each time a block v/ith a number); ba is newly- 
defined by a non-equivalence, store current control in B91 
and jump to n. The block number in ba occupies bits 1 to 
11 and the remaining bits of ba are ignored. The contents 
of Ba are undistunbed. The instruction causing the non- 
equivalence is not executed. n is singly modified, 

1155 ba' = smallest block label i: n defined. Place in bits 
1 to 11 oi oa the smallest block number-^ n which is 
defined for this program. The remaining bits of ba are 
left cleared. (Only bits 1 to 11 of n are used, n is 
singly modified). If all the program's blocks are <-n, 
then bit of ba' is made 1 and the remaining bits are 
cleared 

Descriptions of the extracodes for doing multiple drum transf ers 

1175 Read K + 1 blocks frbm band d, starting at sector k . 

k is th> octal fraction of ba; K is the octal fraction 
of" the singly modified address in the extracode; d must 
already be defined by extracode ll?^. The K + 1 successive 
sectors k, k + 1,..., 3c + K are read to store blocks P, 
p + 1, . . . , P + K. If K is 6 (or 7)> sectors k (or k and 
k + l) will be read twice. Thus if K ~ 6, blocks P and P + 
6 will both contain sector k. (if k is 6 or 7, it is taken 
as or 1 respectively. ) All blocks involved are locked 
doicn. until the entire transfer is complete. 

1176 ¥rite 1£ + 1 blocks to drum band d starting at sector k. 

The definitions of K, k, d are as in 117^. This 
extracode writes store blocks P, P + 1,..., P + K to drum 
sectors k, k + 1,..., k + K. Sectors 6 and 7 are the 
same as sectors and 1. If K exceeds 5 some of the earlier 
blocks are overwritten. Thtis if K = 6, sector k will 
finall3'- contain block P + K rather than block P. 
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AMENDMENT 12 



ABL fault detection 



Sectxon 1» Locating anci identifying faults, permissible density 

of errors, entering a faulty program, program monitored 
during compilation. 

Section 2. ILLEGAL BLOCK and S.^^RED VIOLATION monitoring of 
compiled program. 

Section 3. A list of faults detected by ABL 

Section 4o Optional fault printing during compilation, total 
number of errors ^"if^rmitted , entry despite errors, 
relocating compiled pragram, changing program input 
streams, re-entry to compiler, preset parameters set 
at run time, character count for C directives. 



SECTION 1 Errors detected during compiling will be located and 

identified by one line of fault printing, often followed 
by a copy of the incorrect line. The fault is located 
by printing of the form 

3,6 AlO/6 

which indicates that the fault occurred immediately 
after the third terminator in the sixth new line 
(ignoring blanlc lines) after routine parameter AlO of 
routine 6 was set by labelling (not by an equation) . 
Parameters of other routines are ignored in this context, 

For locating a fault AO/m is taken to be the first 
printed line of routine m, and hence need not refer to 
the saine line as program parameter AO/m, The first 
line of a routine will normally be the routine direct- 
ive „ If no z'outine is specified at the head of the 
program, then a heading RO will be assumed, and the 
first line actually printed will be called lAO/O, 



'.arable 










program 


lo 


cation of line 




(ro assxuned) 

+6 

Al6 - 




AO/O 

1 AO/O 

2 AO/O 




(blarJc line) 
121 6 4 

R3 

Ai66 = 3 




3 AO/O 

AO/3 

1 AO/3 




Z 

l)+6 • 




2 AO/3 
Al/O 



PAGS l4 

E & A NO. 2 

... AUGUST 1964, 

The Items -within a line (©ogs, line 3AO/o) are located 
as follows ! 

121. 6 4 (Newline) 

0,1A0/0 1,lA0/0 2,lA0/0 3j1A0/0 

A pJarsise to identify the type of fault is printed on 
the same line as the location'o Faults detected include 
attempts to store program in an address higher than J33 
impex-missible character in a format that has been x'ecognised} 
overflow on forcing an exponent, and unrecognised format. 
Each of these is followed on the next line by a copy of the 
incorrect line. All characters not recognized in A3L are 
printed as CsC' ; all compound characters as ",' The 
S3nnbols £, j 'j-^ and \ are all printed as I »' & is 

printed as M; the letters I, are printed as the figures 

1, o: 

Attempts to set routine parameters more than once cause 
printing of all locations where the settings were repeated. 

An expression that cannot be fully evaluated is evaluated 
as far as possible, and thenprinted out as a separate fault 
each time it appears in the program. 

Compiling will cease if more than eight errors are found 
in any twenty— four consecutive lines of print out (not including 
blank lines). Then 

TOO MilNY ERRORS 

is printed, and the run ends'» 

If any errors are found in t he compiled program an E or 
ER directive will not be obeyed and ABL will print 

ERRORS DO NOT EWTER 

and end the run. However, an EX directive is obeyed regardless 
of ex-rors , 

It may be useful to know whether a nan has ended during 
compiling or during execution of the program^ During compiling, 
B3 is always in the range -127 to Oo The most likely value is 
~127o B3 is cleared before an E directive is obeyed, as indeed 
are Bl to BBS, (b89 always contains the final value of *» 
After E, B90 contains J3j af ter .ER and EX E90 is clear.) 

SECIIGH 2 "IJlien a faulty item is encountered, zero will usually be 
stored in its place in the compiled program. However if the 
item is an expression that cannot be evaluated because of an 
tmeet parameter the expression is evaluated from the left up 
to the unset parameter and the resulting va2u;e is stored. 
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When the expression following an enter directive 
is faulted for any reason, the expression is given the 
value 10", If the enter directive is then obeyed it 
will cause a Supervisor monitor on ILLEGiiL BLOCK, 
xirith the contents of the current instruction UNALLOCATED. 

In other cases where an expression cannot be 
evaluated, it is given the value J36 or J36YI. If the 
expression is put in the address part of an instruction, 
and the instruction subsequently obeyed, it is likely 
to cause a monitor on ILLEGAL BLOCK, since J36 is an 
address in the Supervisor working store. 



SECTION 3 The following is a list of phrasospincstly self" expianatoryj 
that ABL prints upon encountering a fault. 

Note printed Example 
LABEL ALREADY SET AT 
EXPPvESSION INDETSRMIMITE 
Ln NON-EXISTENT 

INSTRUCTION? lAl ,1,0,3 

EXCESS COMMA 121, 1,0,, 3 

IMPERMISSIBLE + H ++4 

NOT TERMINATED A6H2 

WRONG FORMA.T +l(?) 

LABEL NOT ALLOWED 2) Al = 1 
Z IN RO 

SHIFT > 23 PLACES 2D29 

AO ON FIXING +1-0 

IRREGULAR FUNCTION 721,1,0,0 

OCTAL ITOMBER CONTAINS 8/9 HJ9 

* OUT OF RANGE * = J3 + 1 

PARAMETER OR ROUTINE NUMBER TOO BIG A6OQO = 1 

Before listing any errors ABL prints ABL MONITQEUNG. <» 

SECTION _4 There are several special parameters, numbered from 

PlOO upward, which are connected with ABL fault print- 
ing. They are set in the same way as ordinary preset 
parameters (see section 5.2), and are listed below, 

PlOO - Optional Printing 

At the start of compiling ABL sets PlOO to zero. 
Non-zero settings cause ABL to print various kinds of 
information during compiling, PlOO is treated by ABL 
as made up of eight octal digits abcdefgh. Each octal 
digit Controls the printing of one kind of information, 
as listed below. If the least significant bit of an 
octal digit is one, the information controlled by this 
digit vrlll be printed - on a. new line if the middle bit 
of the digit is one, on the same line if the middle 
bit is zero. If the most significant bit of b (see 
belovj) is 1, then the start and title of library 
routines are printed on a new line; otherwise the most 
significant bit is ignored. If the least significant 
bit is zero, the other two bits are ignored. 
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The kind of printing conti*olled by each, octal 
digit is listed below. All printing is preceded by 
a space, except R. 

OCTAL 
DIGIT 

a 
b 



lUNTERED 3Y COMi'ILER 


PRINTED 




* = esipression 


* = p 




Rn 


Rn * = 


q 


Ln 


Ln * = 
(title) 


qj 


Z 


Z * = 


q 


(ignored) 






Pill = expression 


P 




E expression 


Ep 




ER expression 


ERp 




EX expression 


EXp 





c 
d 
e 
f 

S 
h 

p is the value of the expression, q the cutrent 
setting of *, 

PlOl - Pexnnitted total number of errors 

At the start of compiling ABL sets PlOl to 0.2, 
This puts no effective limit on the number of faults, since 
for each error met PlOl is reduced by one, and compiling 
stops when PlOl = 0, The run ends after printing " 

TOO I'lkirf ERRORS 

The program may set PlOl = n, and counting from that point 
compiling will stop when n + 1 errors have been met, PlOl = 
may be useful for a developed program. For the purpose 
of counting errors, all pareimeters still not set when the 
E directive is met are combined into one error, 

P1C2' '- Entry despite errors 

At the start of compiling, ABL sets P102 = 0.2. If errors 
have been found, an EX directive will still be obeyed, but 
E or ER will not. The program may set P102 as follows :- 

P102 = All E directives obeyed despite errors. 
P102 =0.3 No E directives obeyed after errors. 
P102 =0.1 E and ER obeyed, but EX not obeyed 
after errors , 

PllO - Be location of compiled program 

At the start of compiling, ABL sets PllO = 0. This specifies 
: the difference between * as evaluated in expressions (*-i) and 
■X- ss indicating where items are to be stored (*2)« Thus 

PllO = *i - *2 

Setting PllO = permits the compiling of prograin into one 
set of store addresses for later execution in another s et 
of store addresses. For example if a program is to be 
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executed while stored at addresses at J3, but compiled 
initially into store starting at Jl, it would have at 
its start the directives 

PllO = J2 
* = J3 



The instinictions 



121 1 J3 
116^^ 1 Jl 



would be necessary to rename block Jl as J3 before entering 
the program in J3» 

Pill -' Printing the values of expressions 

When ABL meets the equation 

Pill = expression 

it evaluates the expression and sets Pill in the usual 
way. If the appropriate bit of PlOO is set, the value 
of the expression is immediately printed out. 

PII3 ~ Change of input stream 

The equation P115 = n causes ABL to start reading 
program from the programmers' s input stream n. The rest 
of the line on which P115 occurs is ignored. 

P120 - Be-entrv to compiler 

After ER or EX directives the compiler and parameters 
are retained in store and may be referred to directly. The 
compiler may be re-entered at the address specified by the 
value of P120 to read more program, all parameter settings 
being left unchanged. The value of * is stored by *he 
compiler when the ER or EX directive is encountered and, 
when re-entered at P120, the compiler will read the next 
line after the line containing the enter directive and store 
the first item it finds at the address specified by the 
retained valve of *. Thus, the program is compiled into the 
same locations that it would be if the ER or EX directive 
were not there. 

P121 — Preset parameter list 

P121 is the start of the compiler's preset parameter 
list. Half word nP121 contains the value of Pn if Pn has 
been set. This list can only be referred to by a Program 
entered by an ER or EX directive. (it should be noted that 
this is a list of alternate half words.) 

P122 is the address of the start of the list which 
indicates whether a given preset parameter is set or not. 
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Counting to 23 (most to least significant bits) bit one 
of half word nP122 is a one if Pn is unset, zero if set. 
This is also a list of alternate half words, and the other 
bits of these half words should not be disturbed. (See 
5.3.1.) 

P123 -- Character count (See section 5.10. C directives) 

After each C directive, F123 is set by the compiler to 
the number of characters stored (as a 24-bit integei-) plus 
J4 if no carriage control character has been specified. 
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Proff:ram Errors detected by the Supervisor 



FAULT 



DETECTED 
HCIJITOR PRINTING BY 



MARK OR 
COUNT 
IN B91 
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TRAP 

NUMBER 

(if aity) 



Local time expired 

Division Overflow 

Exponent Overfloi-.'- 

Page locked do-.m 

Number of blocks 
exceeded 

Square root argu- 
ment ' 

Logarithm argument 

SPARE 

Inverse trig, 
function 

Reading after 
Input Ended 

End of Magnetic 
tape 

Variable length 
record error 

Magnetic Tape 
failures 

Computer failures 

Unassigned Function 

Sacred Violation 
Instruction 

Sacred Violation 
Operand 

Illegal block 
number 

Band not reserved 

Computing time 
expired 

Execution time 
expired 

Input not defined 
Output not defined 
Output exceeded 
Tape not defined 
Illegal search 

No selected tape 



L TIME EXCEEDED 
DIV OVERFLOW 
EXP OVERFLOW 
PAGE LOCIvED BO\m 

EXCESS BLOCKS 

SQRT -VE ARG 
LOG -VE ARG 



INVERSE TRIG OUT 
OF RANGE 

INPUT ENDED 

END TAPE 

V TAPE®ROR 

TAPE FAIL 
CCMPUTER FAIL 
ILLEGAL FUNCTION 

SV INSTRUCTION 

SV OPERAND 

ILLEGAL BLOCK 
BAND NOT RESERVED 
C TIME EXCEEDED 

E TIME EXCEEDED 
INPUT NOT DEFINED 
OUTPUT NOT DEFINED 
OUTPUT EXCEEDED 
TAPE NOT DEFINED 
ILLEGAL SEi\RCH 

NO TAPE SELECTED 



s 


Bit 5 





I 


Bit 6 


1 


I 


Bit Ik 


2 


s 


Bit 1 


3 


s 


2„0 


4 


E 


2.^ 


5 


E 


3.0 


6 

7 


E 


4.0 


8 


s 


h,k 


9 


S 


5.0 


10 


B 


5A 


11 


S 


6.0 


12 


S 


6.4 


13 


I 


Bit k 




I 


Bit 8 




I 


Bit 10 




s 


9.6 




S 


10.2 




S 


Bit 2. 




S 


Bit 3 




s 


11,6 




s 


12.2 




s 


12.6 




s 


13.2 




s 


13.6 




s 


14,2 





PAGE 20 

2 & A N0„2 

AUGUST 1964 o 



FAULT 



mmi CR 
DETECTED COUT^TT 
MONITOR FHIIWING BY IN B91 



No mode deTined or 
attempt to write 
■when not permitted 

Number of decks 
exceeded 



1-JRONG TAPS MODE 



EXCESS DECKS 



15,2. 



No trap set 



TRAP UNSET 



15 ;6 



Number of branches 
exceeded 



EXCESS BilAlTCHES 



16^2 



(l = Interrupt; E = Extracode; S = S.S.R.) 



The last three of the above faults are not defined in the 
programming manual. They are j— 



EXCESS DECKS 



The program has called for a tape to 
be mounted by a 'mount' extracode when 
the program was using all the tape 
decks it had reserved in the job 
descrii^tion^' 



TRAP UNSET 



The extracode 113^ to enter a trap has 
been encountered before the extracode 
1132 that sets the trap. 



EXCESS BRAHCHES : 



A new branch of the program has been 
asked for at a time when the program 
already had as many branches active 
ae it had asked for with the 1103 
extracodeo 
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AI''ISN"DI--i5]^]T 1^. 

The 13.17 extracode ('end program') 



The 1117 extracode prints on output the number of* 
instxnxction counter interrupts (units of 2048 instructions) 
that have occurred during the complete run, and also 
during compiling, together vriLth the amount of store 
reserved by the job description, the amount actually in 
use at the end of the mn and the number of blocks 
accepted on each input stream. The waiting time in 
seconds',' and the number of blocks transferred on each 
magnetic tape are also printed. The number of blocks 
accumulated for each output stream is printed at the end 
of each stream. The operators are instructed to disengage 
and rewind all tapes used. The program is then cleared 
from the store. 

For example a program ended by the 1117 extracode might 
pidnt the following infonaation on output 0» 

INSTRUCTION 6l 57 

STCIRE 10 /8 

1 DECKS 5 TAPE BLOCKS 1 HALT TI^SS 

INPUT 1 BLOCKS 

OUTPUT ) ANY 1 3 LOCKS 

ENSND OUTPUT 1 BLOCKS 

INSTRUCTION 6l 57 

This neans that 57 interrupts were used to compile the 
program and 6l to compile and execute it » Multiplication 
orders are counted as 2 and division orders as h", 

STORE 10 l8 

The program asked for 10 blocks in the job description 
and 8 were in use when the 1117 extracode %v'as encountered'," 
including one for each of the input eind output streams in 
the job description, 

1 DECKS 5 TAPE BLOCKS -. HALT TIME 

One taioe deck was reserved, 5 tape transfers have occured 
and the program was suspended by the Supervisor for a total 
of 1 second awaiting the completion of tape transfers. 
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INPUT 1 BLOCKS 

One block was needed in the input well to hold the 
■uncompiled program (and any data that followed the 
program's enter directive), 

OUTPUT ANY 1 BLOCKS 

One block of lineprinter output was held in the output 
well. There is a similar line for each output stream, 

END OUTPUT 1 BLOCKS 



This is the end of output 0,' 
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The following documents should be added to the list 
of references given in Appendix A 
(page 95T 

OS 376 Introduction to Fortran for the Atlas computer 

CS 377 Algol 60 report 

CS 378 Reference manual for Atlas Algol (lorovisional) 

CS 379 A px-imer of Algol 60 for Atlas 

CS 383 Atlas user's description of the L.P. input scheme 

CS 384 Summacized programming information 

CS 390 Primer of Fortran programming 

CS 395 In/Output for Algol on Atlas 

CS 399 Peripherals for Atlas 

R 70 Processing commercial data in> Atlas 

R 76 The compiler compiler 

Atlas Extracodes (annotated programs for 
extrac ode 1200 and above) 
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